---
title: StatusBar | gluestack-ui

description: Component to control the app's status bar. The status bar is the zone, typically at the top of the screen, that displays the current time, Wi-Fi and cellular network information, battery level and/or other status icons. It is embedded react-native `StatusBar` with all utility props of `gluestack-ui/themed`.
---

import { Meta } from '@storybook/addon-docs';
import { useRef, useEffect, useState } from 'react';

<Meta title="ui/Components/React Native Components/StatusBar" />

# StatusBar

Following is the default implementation of the **StatusBar** component without any additional customization. This serves as a starting point for users who are new to this library and want to learn about the basic functionality and appearance of the component.

> Note: StatusBar component is an iOS/Android only component, please try the example on the respective devices.

<iframe
  src="https://snack.expo.dev/embedded/@gluestack/statusbar-example-gluestack-ui?iframeId=ejpussm57k&preview=true&platform=web&theme=dark"
  style={{ width: '100%', height: '60vh', border: '0px' }}
/>

<br />

> Note: You can refer [here](https://github.com/gluestack/gluestack-ui/tree/main/packages/themed/src/components/StatusBar/styled-components) to learn about default styling of StatusBar component

### Import

To use this component in your project, include the following import statement in your file.

```bash
import { StatusBar } from '@gluestack-ui/themed';
```

### Anatomy

The structure provided below can help you identify and understand a StatusBar component's various parts.

```jsx
export default () => <StatusBar />;
```

### API Reference

The following section contains a comprehensive list of the component's references, including descriptions, properties, types, and default behavior. This information is readily available for you to access, helping you effectively utilize the component library in your projects.

### StatusBar

It inherits all the properties of React Native's [StatusBar](https://reactnative.dev/docs/StatusBar) component.
